home *** CD-ROM | disk | FTP | other *** search
/ SGI Developer Toolbox 6.1 / SGI Developer Toolbox 6.1 - Disc 1.iso / toolbox / documents / OpenGL / extensions / man / glxcreatecontext.z / glxcreatecontext
Encoding:
Text File  |  1996-11-11  |  6.5 KB  |  133 lines
  1.  
  2.  
  3.  
  4. ggggllllXXXXCCCCrrrreeeeaaaatttteeeeCCCCoooonnnntttteeeexxxxtttt((((3333GGGG))))        OOOOppppeeeennnnGGGGLLLL RRRReeeeffffeeeerrrreeeennnncccceeee ---- GGGGLLLLXXXX        ggggllllXXXXCCCCrrrreeeeaaaatttteeeeCCCCoooonnnntttteeeexxxxtttt((((3333GGGG))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      ggggllllXXXXCCCCrrrreeeeaaaatttteeeeCCCCoooonnnntttteeeexxxxtttt - create a new GLX rendering context
  10.  
  11.  
  12. CCCC SSSSPPPPEEEECCCCIIIIFFFFIIIICCCCAAAATTTTIIIIOOOONNNN
  13.      GLXContext ggggllllXXXXCCCCrrrreeeeaaaatttteeeeCCCCoooonnnntttteeeexxxxtttt( Display *_d_p_y,
  14.                                   XVisualInfo *_v_i_s,
  15.                                   GLXContext _s_h_a_r_e_L_i_s_t,
  16.                                   Bool _d_i_r_e_c_t )
  17.  
  18.  
  19. PPPPAAAARRRRAAAAMMMMEEEETTTTEEEERRRRSSSS
  20.      _d_p_y        Specifies the connection to the X server.
  21.  
  22.  
  23.      _v_i_s        Specifies the visual that defines the frame buffer resources
  24.                 available to the rendering context.  It is a pointer to an
  25.                 XXXXVVVViiiissssuuuuaaaallllIIIInnnnffffoooo structure, not a visual ID or a pointer to a
  26.                 VVVViiiissssuuuuaaaallll.
  27.  
  28.  
  29.      _s_h_a_r_e_L_i_s_t  Specifies the context with which to share display lists.  NNNNUUUULLLLLLLL
  30.                 indicates that no sharing is to take place.
  31.  
  32.  
  33.      _d_i_r_e_c_t     Specifies whether rendering is to be done with a direct
  34.                 connection to the graphics system if possible (TTTTrrrruuuueeee) or
  35.                 through the X server (FFFFaaaallllsssseeee).
  36.  
  37.  
  38. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  39.      ggggllllXXXXCCCCrrrreeeeaaaatttteeeeCCCCoooonnnntttteeeexxxxtttt creates a GLX rendering context and returns its handle.
  40.      This context can be used to render into both windows and GLX pixmaps.  If
  41.      ggggllllXXXXCCCCrrrreeeeaaaatttteeeeCCCCoooonnnntttteeeexxxxtttt fails to create a rendering context, NNNNUUUULLLLLLLL is returned.
  42.  
  43.      If _d_i_r_e_c_t is TTTTrrrruuuueeee, then a direct rendering context is created if the
  44.      implementation supports direct rendering and the connection is to an X
  45.      server that is local.  If _d_i_r_e_c_t is FFFFaaaallllsssseeee, then a rendering context that
  46.      renders through the X server is always created.  Direct rendering
  47.      provides a performance advantage in some implementations.  However,
  48.      direct rendering contexts cannot be shared outside a single process, and
  49.      they cannot be used to render to GLX pixmaps.
  50.  
  51.      If _s_h_a_r_e_L_i_s_t is not NNNNUUUULLLLLLLL, then all display-list indexes and definitions
  52.      are shared by context _s_h_a_r_e_L_i_s_t and by the newly created context.  An
  53.      arbitrary number of contexts can share a single display-list space.
  54.      However, all rendering contexts that share a single display-list space
  55.      must themselves exist in the same address space.  Two rendering contexts
  56.      share an address space if both are nondirect using the same server, or if
  57.      both are direct and owned by a single process.  Note that in the
  58.      nondirect case, it is not necessary for the calling threads to share an
  59.      address space, only for their related rendering contexts to share an
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. ggggllllXXXXCCCCrrrreeeeaaaatttteeeeCCCCoooonnnntttteeeexxxxtttt((((3333GGGG))))        OOOOppppeeeennnnGGGGLLLL RRRReeeeffffeeeerrrreeeennnncccceeee ---- GGGGLLLLXXXX        ggggllllXXXXCCCCrrrreeeeaaaatttteeeeCCCCoooonnnntttteeeexxxxtttt((((3333GGGG))))
  71.  
  72.  
  73.  
  74.      address space.
  75.  
  76.  
  77. NNNNOOOOTTTTEEEESSSS
  78.      XXXXVVVViiiissssuuuuaaaallllIIIInnnnffffoooo is defined in _X_u_t_i_l._h.  It is a structure that includes
  79.      _v_i_s_u_a_l, _v_i_s_u_a_l_I_D, _s_c_r_e_e_n, and _d_e_p_t_h elements.
  80.  
  81.      A _p_r_o_c_e_s_s is a single execution environment, implemented in a single
  82.      address space, consisting of one or more threads.
  83.  
  84.      A _t_h_r_e_a_d is one of a set of subprocesses that share a single address
  85.      space, but maintain separate program counters, stack spaces, and other
  86.      related global data.  A _t_h_r_e_a_d that is the only member of its subprocess
  87.      group is equivalent to a _p_r_o_c_e_s_s.
  88.  
  89.  
  90. EEEERRRRRRRROOOORRRRSSSS
  91.      NNNNUUUULLLLLLLL is returned if execution fails on the client side.
  92.  
  93.      BBBBaaaaddddMMMMaaaattttcccchhhh is generated if the context to be created would not share the
  94.      address space or the screen of the context specified by _s_h_a_r_e_L_i_s_t.
  95.  
  96.      BBBBaaaaddddVVVVaaaalllluuuueeee is generated if _v_i_s is not a valid visual (e.g., if the GLX
  97.      implementation does not support it).
  98.  
  99.      GGGGLLLLXXXXBBBBaaaaddddCCCCoooonnnntttteeeexxxxtttt is generated if _s_h_a_r_e_L_i_s_t is not a GLX context and is not
  100.      NNNNUUUULLLLLLLL.
  101.  
  102.      BBBBaaaaddddAAAAlllllllloooocccc is generated if the server does not have enough resources to
  103.      allocate the new context.
  104.  
  105.  
  106.  
  107. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  108.      ggggllllXXXXDDDDeeeessssttttrrrrooooyyyyCCCCoooonnnntttteeeexxxxtttt, ggggllllXXXXGGGGeeeettttCCCCoooonnnnffffiiiigggg, ggggllllXXXXIIIIssssDDDDiiiirrrreeeecccctttt, ggggllllXXXXMMMMaaaakkkkeeeeCCCCuuuurrrrrrrreeeennnntttt
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.